home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / compress / dxp203.zip / DXP.DOC next >
Text File  |  1992-10-23  |  39KB  |  1,137 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                                             Disk eXPress
  9.  
  10.                                                             for Creating
  11.                                                          Diskette Images
  12.  
  13.                                                                      DXP
  14.                                                             Version 2.03
  15.                                                                 10/23/92
  16.  
  17.  
  18.  
  19.                                   TABLE OF CONTENTS
  20.        _________________________________________________________________
  21.  
  22.             1.0. INTRODUCTION TO Disk eXPress ........................3
  23.                  1.1. What is Disk eXPress? ..........................3
  24.                  1.2. Features of Disk eXPress .......................3
  25.                  1.3. New features in Disk eXPress Version 2 .........4
  26.                  1.4. New Disk eXPress companion program: Xtract .....5
  27.             2.0. SYSTEM REQUIREMENTS .................................5
  28.             3.0. COPYRIGHT NOTICE ....................................5
  29.             4.0. WARRANTY ............................................6
  30.             5.0. COST OF Disk eXPress ................................6
  31.             6.0. CONTENTS OF THIS PACKAGE ............................6
  32.             7.0. SYNTAX ..............................................7
  33.                  7.1. Quick start ....................................7
  34.                  7.2. Disk eXPress help screens ......................8
  35.             8.0. COMMAND LINE SWITCHES DESCRIPTION ...................10
  36.                  8.1. Regular mode ...................................10
  37.                  8.2. Extract mode ...................................11
  38.                  8.3. Batch mode support .............................12
  39.                  8.4. Disk eXPress real-time bar graph display .......12
  40.             9.0. EXAMPLES ............................................13
  41.                  9.1. Example 1 ......................................13
  42.                  9.2. Example 2 ......................................14
  43.                  9.3. Example 3 ......................................14
  44.                  9.4. Example 4 ......................................15
  45.                  9.5. Example 5 ......................................15
  46.                  9.6. Example 6 ......................................16
  47.                  9.7. Example 7 ......................................17
  48.             10.0. ERROR MESSAGES .....................................18
  49.             11.0. LIMITATIONS ........................................20
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.                                                                        2
  75.  
  76.  
  77.  
  78.        1.0. INTRODUCTION TO Disk eXPress
  79.        _________________________________________________________________
  80.  
  81.  
  82.        1.1. What is Disk eXPress?
  83.  
  84.        Disk eXPress (DXP) allows a diskette image to be created for
  85.        electronic transmission.  Think of it as a way for preparing a
  86.        diskette to be FAXed like a regular document.  Once the diskette
  87.        image is created, it can be transmitted with the use of a modem
  88.        on a regular phone line, or any other electronic networks.
  89.  
  90.        One area of use is to archive diskette images on hard drives or
  91.        tapes.  This can be useful for companies maintaining an
  92.        electronic bulletin board service for clients, in which diskette
  93.        images for the latest hardware drivers, or fixes are available
  94.        for download.  This guarantees the contents of the diskette to be
  95.        the same as the original -- including all directory structures,
  96.        date and time stamps of all the files and directories, and the
  97.        location of any hidden information.
  98.  
  99.        For simple file archival purpose, the use of Disk eXPress should
  100.        be avoided.  The user is encouraged to use one of the many fine
  101.        archive programs available on the market.  Disk eXPress is useful
  102.        for archiving bootable diskettes, diskettes containing hidden
  103.        information, or files and directory entries containing characters
  104.        unrecognizable by the usual file system functions.  Unlike a file
  105.        archive program, Disk eXPress requires a diskette drive and a
  106.        diskette in order to restore any information stored in an image.
  107.  
  108.  
  109.        1.2. Features of Disk eXPress
  110.  
  111.        -  Disk eXPress recognizes all standard DOS formatted diskettes,
  112.           this includes 160K, 180K, 320K, 360K, 720K, 1.2M, 1.44M, and
  113.           the latest 2.88M diskettes.  Any internal or external diskette
  114.           drives connected via DOS or OS/2 block device drivers are
  115.           recognized (ie: diskette drives accessed via DRIVER.SYS,
  116.           $FDD5.SYS, etc.)  All information on the diskette is saved to
  117.           a file for electronic transmission, no information is lost!
  118.           (see /a switch for detail).
  119.        -  Disk eXPress can be used for diskette conversion.  For
  120.           example, a 360K diskette image can be restored onto a 720K,
  121.           1.44M, or 2.88M diskette.  If someone sends you a bootable
  122.           360K diskette image, you can restore it onto a 720K diskette,
  123.           and the resulting diskette will be bootable.
  124.        -  Advanced virus protection.  Disk eXPress detects illegal
  125.           program modifications whether it's by virus, or bad electronic
  126.           transmissions.
  127.        -  Multiple 32-bit CRC data protection.  The image is protected
  128.           by several 32-bit CRCs.  In some cases, if a non-critical part
  129.           of the image is modified, the resulting diskette will still be
  130.           usable.
  131.  
  132.  
  133.                                                                        3
  134.  
  135.  
  136.  
  137.        -  Upgradability of the self-extract code.  Disk eXPress provides
  138.           a means to upgrade the self-extract code within the image file
  139.           for bug fixes, and future code enhancements upgrade.
  140.  
  141.        (note: version 2 image is not compatible with version 1.
  142.         Replacement of version 1 self-extract code is not allowed.)
  143.  
  144.  
  145.  
  146.        1.3. New features in Disk eXPress Version 2
  147.  
  148.        -  Disk eXPress is now a dual mode executable file.  It runs
  149.           under both OS/2 and DOS.  There is only one version of the
  150.           executable as opposed to two in the previous release.
  151.        -  Disk eXPress exploits the multi-threading capability when it
  152.           is run under OS/2.  It performs simultaneous disk I/O and data
  153.           compression.  This typically gives 10 to 50% speed up compare
  154.           to running it under DOS.
  155.        -  Disk eXPress supports long filename for diskette images
  156.           created under OS/2 with HPFS (High Performance File System)
  157.           disk partition.
  158.        -  New data compression algorithm based on a modified Lempel-Ziv-
  159.           Huffman method.  Disk eXPress now compresses smaller than
  160.           version 1, and is also 2 to 3 times faster.  The compression
  161.           rate is comparable to most file archive programs.  Compression
  162.           is dynamic -- non-compressible data is simply stored.
  163.        -  Real-time bar graph display showing current compression rate,
  164.           disk read/write and compression activities (this capability is
  165.           limited under DOS).
  166.        -  Self-extracting diskette image is also a dual mode executable.
  167.           /DOS and /OS2 switches are no longer required (please refer to
  168.           version 1 documentation).  All the extra functions are
  169.           removed, and are now built-into the extract mode of Disk
  170.           eXPress itself.
  171.        -  Disk eXPress can now produce non-self-extract image (pure
  172.           image data).  This is useful for diskette archival purpose on
  173.           hard drive or tape.
  174.        -  Diskette decompression code is now built-into Disk eXPress.
  175.           This can be used to decompress version 2 pure diskette image
  176.           or Disk eXPress version 1 or 2 self-extract images.  It has
  177.           the full set of options, including diskette formatting,
  178.           conversion, and verification.  The decompressor is also fully
  179.           multi-threaded under OS/2 to yield the fastest decompression
  180.           time.
  181.        -  A new switch (/t) is added to all the decompressors so that
  182.           the integrity of the image can be tested before committing the
  183.           lengthy diskette write process.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                                                                        4
  193.  
  194.  
  195.  
  196.        1.4. New Disk eXPress companion program: Xtract
  197.  
  198.        -  Xtract is a dual mode executable.  It features all the
  199.           decompression capability of Disk eXPress, including multi-
  200.           threading under OS/2.
  201.        -  It is used for distributing pure diskette images in which
  202.           unlimited distribution right is granted for Xtract after
  203.           purchasing a licensed copy of Disk eXPress.
  204.        -  Xtract is included in the licensed version of Disk eXPress
  205.           (not included in the shareware version).
  206.  
  207.  
  208.        2.0. SYSTEM REQUIREMENTS
  209.        _________________________________________________________________
  210.  
  211.        IBM PC, PC-AT, PS/1, PS/2 and 100% compatibles.  Minimum 256K
  212.        conventional memory.  MS-DOS or PC-DOS version 3.00 for Disk
  213.        eXPress (DOS version 3.20 is required for running self-extract
  214.        images produced by Disk eXPress).  OS/2 1.2 and above (including
  215.        OS/2 Version 2) is required under OS/2.  Hard disk is required
  216.        for storing large image file.  User must also provide the
  217.        necessary program(s) for sending diskette image files through
  218.        telephone network with the use of a modem, and whatever is
  219.        necessary with any other electronic networks.
  220.  
  221.  
  222.        3.0. COPYRIGHT NOTICE
  223.        _________________________________________________________________
  224.  
  225.        DXP (Disk eXPress)  Version 2.03  10/23/92
  226.        XTRACT (Xtract)     Version 2.03  10/23/92
  227.        Copyright (c) 1991-92 by
  228.        Albert J. Shan
  229.  
  230.        All Rights Reserved.  No part of this program may be
  231.        disassembled, modified or altered by any means.
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.                                                                        5
  252.  
  253.  
  254.  
  255.        4.0. WARRANTY
  256.        _________________________________________________________________
  257.  
  258.        I, Albert J. Shan, make no warranties, expressed or implied,
  259.        including, but not limited to, merchantability or fitness for any
  260.        particular purpose.  In no event shall Albert J. Shan be liable
  261.        for indirect or consequential damages arising from the use of the
  262.        software program.
  263.  
  264.        You are free to redistribute this shareware package in its
  265.        entirety.  No part of this package may be included as part of a
  266.        commercial package.  If you have any questions about commercial
  267.        distribution of Disk eXPress, I can be contacted at:
  268.  
  269.        Albert J. Shan
  270.        866 Citadel Drive
  271.        Port Coquitlam, British Columbia
  272.        CANADA  V3C 5Y1
  273.  
  274.        or via CompuServe, ID 70730,401
  275.  
  276.  
  277.  
  278.        5.0. COST OF Disk eXPress
  279.        _________________________________________________________________
  280.  
  281.        Disk eXPress Version 1 was labeled as "beggarware" in which user
  282.        is not required to pay a fee.  Due to all the effort and time I
  283.        put in for Version 2, it is now marketed as shareware.  The user
  284.        is granted a 30 days trial period, after which he or she is
  285.        required to register the product.  The cost of a single machine
  286.        license is $24 Canadian.  Unlimited distribution right of Xtract
  287.        is granted upon licensing Disk eXPress.  Please refer to the file
  288.        ORDER.FRM for details.
  289.  
  290.  
  291.  
  292.        6.0. CONTENTS OF THIS PACKAGE
  293.        _________________________________________________________________
  294.  
  295.        The following files are included in this package:
  296.  
  297.            DXP.EXE    - Disk eXPress executable
  298.            DXP.DOC    - This documentation
  299.            DXP.HST    - History file
  300.            ORDER.FRM  - Order form
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.                                                                        6
  311.  
  312.  
  313.  
  314.        7.0. SYNTAX
  315.        _________________________________________________________________
  316.  
  317.        7.1. Quick start
  318.  
  319.        The syntax of Disk eXPress is very similar to the COPY command.
  320.        To create a diskette image, type:
  321.  
  322.          dxp drive: filename
  323.  
  324.        To create a diskette from an image file, type:
  325.  
  326.          dxp filename drive:
  327.  
  328.        For example, to create a diskette image from your drive B:,
  329.        simply type:
  330.  
  331.          dxp b: my_image
  332.  
  333.        The file "my_image.exe" will be created after Disk eXPress is
  334.        finished.
  335.  
  336.        To create the diskette from the self-extract file created above,
  337.        you type:
  338.  
  339.          my_image b:
  340.  
  341.        OR
  342.  
  343.          dxp my_image.exe b:
  344.  
  345.        Disk eXPress allows command switches to be specified anywhere on
  346.        the command line.  Spaces between command line switches are not
  347.        required.  By default, the file extension is ".EXE" regardless of
  348.        what user specifies.  When creating a pure diskette image with
  349.        the /i switch, user is free to choose the file extension.  For
  350.        consistency, the recommended file extension to use is ".DXP".
  351.  
  352.        For example, under OS/2 with HPFS drive, a pure diskette image
  353.        can be created as follows:
  354.  
  355.          dxp a: "This is diskette 3 of 5.DXP" /i
  356.  
  357.        To create the diskette from the image:
  358.  
  359.          dxp "This is diskette 3 of 5.DXP" a: /f /v
  360.  
  361.        The /f switch tells Disk eXPress to format the diskette a track
  362.        at a time just before each track write.
  363.  
  364.        The /v switch tells Disk eXPress to verify the diskette write
  365.        after the track is written.
  366.  
  367.  
  368.  
  369.                                                                        7
  370.  
  371.  
  372.  
  373.        You may stop Disk eXPress at any time by pressing Ctrl-C or Ctrl-
  374.        Break.  The BREAK ON/OFF setting under DOS is ignored.
  375.  
  376.        If Disk eXPress encounters any cluster marked as bad in the File
  377.        Allocation Table, you may receive a warning:
  378.  
  379.         X bad cluster(s) detected.
  380.         Bad clusters may not be reliably read by Disk eXPress!
  381.         However, if you do not encounter any 'Abort/Retry?'
  382.         message during read, the image should be fine.
  383.  
  384.        Note:
  385.        Disk eXPress will not detect bad clusters in advance if you by-
  386.        pass File Allocation Table (FAT) scanning by specifying the /a
  387.        switch.
  388.  
  389.        Disk eXPress or Xtract cannnot restore a diskette image onto a
  390.        diskette that contains physically bad sectors.
  391.  
  392.  
  393.        7.2. Disk eXPress help screens
  394.  
  395.        Type DXP at the OS/2 or DOS prompt to receive this help screen:
  396.  
  397.         Disk eXPress (OS/2 and DOS) Version 2.03  10/23/92
  398.         Created by Albert J. Shan  Copyright (c) 1991-92  SHAREWARE VERSION
  399.  
  400.         Regular mode: DXP [options] [drive:] [d:][path]filename
  401.            [options]  /?    Display extract mode help screen
  402.                       /a    Read the entire disk (all sectors)
  403.                       /d    Input diskette image description (5 lines max.)
  404.                       /i    Output just the diskette image
  405.                       /n    Disable data compression
  406.                       /s    Suppress overwrite prompt and self-check message
  407.                      drive  Drive letter of a valid floppy drive
  408.         [d:][path]filename  Name of output file
  409.  
  410.         Valid options with only filename specified:
  411.                       /d    Display description in image file
  412.                       /e    Edit description in image file
  413.                       /r    Replace or add extract code to image file
  414.  
  415.         Note: Items enclosed in [] are optional.
  416.               Diskette must not contain any unreadable sectors.
  417.  
  418.         Supported formats: 160K, 180K, 320K, 360K, 1.2M, 720K,
  419.                            1.44M and 2.88M DOS diskettes.
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.                                                                        8
  429.  
  430.  
  431.  
  432.        Type DXP /?, and you'll get the help screen for the extract mode:
  433.  
  434.         Disk eXPress (OS/2 and DOS) Version 2.03  10/23/92
  435.  
  436.         *** Type DXP by itself to see the regular mode help screen ***
  437.  
  438.         Extract mode: DXP [options] [d:][path]filename [drive:]
  439.            [options]  /t    Test image integrity only
  440.                       /d    Display description in image file
  441.                       /f    Format destination diskette
  442.                       /s    Suppress overwrite prompt and self-check message
  443.                       /v    Verify ON (system verify plus read and compare)
  444.                       /c    Convert image onto a higher density diskette
  445.                             (Target diskette must be pre-formatted, and
  446.                             of different form factor.  It also overrides /f)
  447.         [d:][path]filename  Name of input file
  448.                      drive  Drive letter of a valid floppy drive
  449.  
  450.         Note: Items enclosed in [] are optional.
  451.               The target diskette must be free of defects (no bad sectors).
  452.  
  453.         Supported formats: 160K, 180K, 320K, 360K, 1.2M, 720K,
  454.                            1.44M and 2.88M DOS diskettes.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.                                                                        9
  488.  
  489.  
  490.  
  491.        8.0. COMMAND LINE SWITCHES DESCRIPTION
  492.        _________________________________________________________________
  493.  
  494.        When Disk eXPress is used under regular mode for making diskette
  495.        images, the following switches are available:
  496.  
  497.  
  498.        8.1. Regular mode
  499.  
  500.        /a  By default, Disk eXPress reads up to the last allocated
  501.            sector, according to the information it finds in the File
  502.            Allocation Table (FAT) in order to reduce the size of the
  503.            image file.  However, if there is any deleted files at the
  504.            end of FAT that you may want to recover later, the default
  505.            action will prevent you from a successful file recovery.  Use
  506.            /a to tell Disk eXPress to produce an exact duplicate of the
  507.            original diskette by saving ALL disk sectors to the image
  508.            file.
  509.  
  510.        /d  Prompt user to input description for the diskette image.  A
  511.            maximum of 5 lines of 40 characters each can be stored.
  512.  
  513.        /i  Create a pure diskette image file.  The self-extract code
  514.            will not be bundled with the resulting file.  Disk eXPress
  515.            does not enforce any file extension for pure diskette image.
  516.            For consistency, it is recommended to use ".DXP" as file
  517.            extension.  Without specifying this switch, the default file
  518.            extension will be ".EXE".
  519.  
  520.        /n  Disable compression.  If the contents of the diskette is
  521.            highly compressed, Disk eXPress may not succeed in
  522.            compressing the data any further.  This can be visually
  523.            inspected when Disk eXPress is run the first time without the
  524.            /n switch.  If the real-time compression rate is very low
  525.            (close to 0%), disabling compression is recommended.
  526.  
  527.        /s  Disable any overwrite (y/N) prompt and Disk eXPress self-
  528.            check message.
  529.  
  530.        Three switches are available when no drive letter is specified in
  531.        regular mode:
  532.  
  533.        /d  Display the description of the image file.  The full path to
  534.            the diskette image must be specified.
  535.  
  536.        /e  Edit the description stored in an image file.  This is used
  537.            to correct the description later instead of having to redo
  538.            the entire image from scratch.
  539.  
  540.        /r  Replace or add extract code to image file.  Full path and
  541.            complete filename must be specified.  If /r is used against a
  542.            self-extract diskette image, the self-extract code will be
  543.            replaced with the one stored with Disk eXPress.  No backup
  544.  
  545.  
  546.                                                                       10
  547.  
  548.  
  549.  
  550.            file is created if the operation is successful.  If used
  551.            against a pure image file, the self-extract code will be
  552.            added, and a new file with ".EXE" extension will be created.
  553.            The ".EXE" file created by this switch is stored in the same
  554.            location of the original image file.
  555.  
  556.            Note: The file extension replacement algorithm simply removes
  557.            any file extension starting after the last '.' and then
  558.            appending "EXE".  Since it is possible to use multiple '.'
  559.            under HPFS, the text after the last '.' is discarded.  It is
  560.            advisable to avoid using multiple '.' with HPFS filename, and
  561.            use a space instead.
  562.  
  563.  
  564.        8.2. Extract mode
  565.  
  566.        Disk eXPress can decode and extract 3 types of images: type 0
  567.        (non-compressed), type 1 (Version 1 compression), and type 2
  568.        (Version 2 compression).  When Disk eXPress is used for
  569.        extracting an image file, the image file can be a pure image
  570.        file, or a self-extracting executable.  The full path to the
  571.        image file must be specified.  Wild cards are not allowed.  All
  572.        the switches available in the extract mode of Disk eXPress are
  573.        identical to the standalone Xtract program.
  574.  
  575.        /t  Test the integrity of the image only.  Disk eXPress performs
  576.            data decompression (if necessary) and runs through a 32-bit
  577.            CRC computation on the data stored in the image.  It reports
  578.            the stored and computed CRC values.  If these values do not
  579.            match, the image will be bad.  It overrides the specification
  580.            of a drive letter, /f, /s, /v, and the /c switch.
  581.  
  582.        /d  Display the description of the image file.  The full path to
  583.            the diskette image must be specified.
  584.  
  585.        /f  Format the destination diskette.  Only standard DOS formats
  586.            are supported.
  587.  
  588.        /s  Disable any overwrite (y/N) prompt and Disk eXPress self-
  589.            check message.
  590.  
  591.        /v  Verify on.  It performs a track verify via operating system
  592.            call, follows by a track read, and a byte by byte comparison.
  593.            The byte by byte comparison is added as an extra protection
  594.            should the CRC test of track verify failed to pick up an
  595.            error.  If disk cache is used, the byte comparison test may
  596.            not be valid due to the fact that the cache is supplying the
  597.            data, with no actual read performed on the diskette.
  598.  
  599.        /c  Convert the image onto a higher density diskette.  The target
  600.            diskette must be of different form factor (3.5" to 5.25" and
  601.            vice versa, but not 3.5" 720K to 3.5" 1.44M due to hardware
  602.  
  603.  
  604.  
  605.                                                                       11
  606.  
  607.  
  608.  
  609.            limitations).  It requires a formatted diskette, and will
  610.            automatically overrides the /f switch.
  611.  
  612.            Here is a list of all the diskette conversion possibilities:
  613.  
  614.              160K/180K/320K/360K to 720K/1.44M/2.88M
  615.                             720K to 1.2M
  616.                             1.2M to 1.44M/2.88M
  617.  
  618.  
  619.        8.3. Batch mode support
  620.  
  621.        You can use Disk eXPress, Xtract, and self-extract images in a
  622.        batch file (.CMD file under OS/2 and .BAT file under DOS).  The
  623.        return code returned by these programs are currently limited to
  624.        either a 0 or 1.  A return code of 0 indicates operation is
  625.        successful.  All display output is sent to standard out (stdout),
  626.        and can be redirected to a file.  Errors and warning messages are
  627.        sent to standard error (stderr).
  628.  
  629.  
  630.        8.4. Disk eXPress real-time bar graph display
  631.  
  632.        One of the new features of Disk eXPress Version 2 is the use of a
  633.        real-time bar graph display.  Disk eXPress and Xtract will
  634.        exercise the multi-threading capability under OS/2, and you'll
  635.        see a display similar to the following:
  636.  
  637.                                    3%      25%       50%       75%      100%
  638.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  639.           COMPRESS  52%   37    1  █████████████████▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒
  640.  
  641.        The above bar graph depicts 3 concurrent threads:
  642.  
  643.           ▒ Read thread.  Performs continuous reading of diskette (or
  644.             disk file if it is in extract mode), and releases the
  645.             diskette drive (or disk file) for use by another process
  646.             when reading is finished.
  647.           ▓ Compression/decompression thread.  Compression/decompression
  648.             is performed as soon as data is available from the read
  649.             thread.
  650.           █ Write thread.  Compressed data is written to a disk file (or
  651.             decompressed data written to diskette in extract mode).
  652.             This can be another diskette drive or any block device.
  653.  
  654.        The description under "Action" shows which thread has just
  655.        started executing.
  656.  
  657.        The number under "Rate" shows the current compression rate.  It
  658.        is the percentage reduction with respect to the size of the
  659.        original data.
  660.  
  661.  
  662.  
  663.  
  664.                                                                       12
  665.  
  666.  
  667.  
  668.        The numbers under "Track" and "Head" show the current disk track
  669.        and head where operation is being performed.
  670.  
  671.        Since DOS has only one thread of execution, only one bar is
  672.        updated at any time.  Read/Compress/Decompress/Write occurs
  673.        sequentially.
  674.  
  675.  
  676.  
  677.        9.0. EXAMPLES
  678.        _________________________________________________________________
  679.  
  680.        9.1. Example 1
  681.  
  682.        To pack a 360K diskette in drive B: onto a file called 'disk1'
  683.        for modem transmission, you type:
  684.  
  685.            dxp b: e:\upload\disk1
  686.  
  687.        By default, Disk eXPress will automatically append ".EXE" onto
  688.        the output file name.  If you specify something else as file
  689.        extension, it will be removed before appending.  If the command
  690.        line syntax is correct, Disk eXPress will first run a self-check
  691.        for virus/modification, then it will proceed to create the
  692.        diskette image.  You'll receive a screen similar to the following
  693.        after Disk eXPress is finished:
  694.  
  695.           Checking Disk eXPress for modifications ... OK.
  696.  
  697.           360K diskette found in drive B:
  698.  
  699.           File Allocation Table statistics:
  700.           Track 33 head 1 contains the last allocated sector, sector 609.
  701.  
  702.                                    3%      25%       50%       75%      100%
  703.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  704.              STORE  28%   33    1  ████████████████████████████████████████
  705.  
  706.           32-bit CRC of diskette image is DB49A615
  707.  
  708.        By default, Disk eXPress will analyze the FAT and save up to the
  709.        last sector used on the diskette.  In the above example, it stops
  710.        at track 33, head 1, because sector 609 is the last allocated
  711.        sector.  If you have a fragmented diskette, you might receive a
  712.        screen similar to the following when you run Disk eXPress:
  713.  
  714.           Checking Disk eXPress for modifications ... OK.
  715.  
  716.           1.44M diskette found in drive A:
  717.  
  718.           File Allocation Table statistics:
  719.           Track 36 head 1 contains the last allocated sector, sector 1319.
  720.  
  721.  
  722.  
  723.                                                                       13
  724.  
  725.  
  726.  
  727.           Disk fragmentation detected:
  728.           814 unallocated sectors will be saved in image
  729.           (61% of total used sectors).
  730.           The diskette requires compression for maximum storage efficiency.
  731.  
  732.                                    3%      25%       50%       75%      100%
  733.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  734.           COMPRESS  48%   16    0  ██████▓▓▒▒▒▒▒▒▒
  735.  
  736.        etc.
  737.  
  738.        Running a disk optimization utility on the diskette will help
  739.        packing files tightly together for maximum storage efficiency.
  740.        Alternatively, you can copy all the files to another freshly
  741.        formatted diskette so that the files are packed next to each
  742.        other.
  743.  
  744.  
  745.        9.2. Example 2
  746.  
  747.        To save the entire diskette from drive A: (including all the
  748.        unused sectors) onto the image with compression turned off, you
  749.        type:
  750.  
  751.            dxp /a /n a: e:\upload\disk1
  752.  
  753.        You will see this warning if the file exists:
  754.  
  755.           Checking Disk eXPress for modifications ... OK.
  756.  
  757.           E:\UPLOAD\DISK1.EXE exists, overwrite? (y/N):
  758.  
  759.        Default action is 'No' for pressing the 'Enter' key.  Type 'y'
  760.        then 'Enter' to overwrite.
  761.  
  762.        To suppress the warning, specify /s on the command line:
  763.  
  764.            dxp /a /n a: e:\upload\disk1 /s
  765.  
  766.        Notice that you can specify switches anywhere you want on the
  767.        command line, Disk eXPress will sort them out for you.
  768.  
  769.  
  770.        9.3. Example 3
  771.  
  772.        To enter a description when creating an image, you type:
  773.  
  774.            dxp b: test15 /s /d
  775.  
  776.        You'll see:
  777.  
  778.           Checking Disk eXPress for modifications ... OK.
  779.  
  780.  
  781.  
  782.                                                                       14
  783.  
  784.  
  785.  
  786.           Please enter diskette description: (5 lines max.)
  787.             ┌────────────────────────────────────────┐
  788.           1:
  789.  
  790.        You're then prompted to enter a maximum of five lines of
  791.        description (40 characters for each line).  To enter a blank
  792.        line, just press Enter.
  793.  
  794.        To continue our example, type in the following:
  795.  
  796.           Please enter diskette description: (5 lines max.)
  797.             ┌────────────────────────────────────────┐
  798.           1: Joe,
  799.           2: This is the latest beta release of Space
  800.           3: Commander.  Try it out without a joy
  801.           4: stick and let me know how it goes.
  802.           5:   Regards, John
  803.  
  804.           360K diskette found in drive B:
  805.  
  806.           File Allocation Table statistics:
  807.           Track 33 head 1 contains the last allocated sector, sector 609.
  808.  
  809.                                    3%      25%       50%       75%      100%
  810.             Action Rate Track Head ├────────┼─────────┼─────────┼─────────┤
  811.              STORE  28%   16    1  ███████████████████▓▓▒▒▒▒▒▒▒
  812.  
  813.        etc.
  814.  
  815.  
  816.        9.4. Example 4
  817.  
  818.        To change the description of the diskette image produced in the
  819.        last example, type:
  820.  
  821.            dxp e:\upload\test15.exe /e
  822.  
  823.        The /e switch allows description in the image file to be edited.
  824.        Note: The /r switch (self-extract code replacement) can also be
  825.        specified together with the /e switch.
  826.  
  827.  
  828.        9.5. Example 5
  829.  
  830.        Now that you have the self-extract image, what are you going to
  831.        do with it?  Simply run it!  To unpack the disk image created in
  832.        example 3, type 'test15' to see the help screen:
  833.  
  834.           Disk eXPress Self-Extract Diskette Image (OS/2 and DOS)
  835.           Version 2.03  10/23/92  Copyright (c) 1991-92
  836.  
  837.           Usage: TEST15 [/t] [drive:]
  838.  
  839.  
  840.  
  841.                                                                       15
  842.  
  843.  
  844.  
  845.              /t  Test image integrity only
  846.           drive  Drive letter of a valid floppy disk drive
  847.  
  848.           Note: The target diskette must be formatted and must not
  849.                 have any bad sectors.
  850.  
  851.        To finish our example, now type:
  852.  
  853.            test15 b:
  854.  
  855.        You'll see:
  856.  
  857.           ┌────── Diskette Image Description ──────┐
  858.            Joe,
  859.            This is the latest beta release of Space
  860.            Commander.  Try it out without a joy
  861.            stick and let me know how it goes.
  862.              Regards, John
  863.           └────────────────────────────────────────┘
  864.           360K diskette image stored in file.
  865.  
  866.  
  867.           Diskette in drive B: is about to be overwritten
  868.           with new information.  Do you wish to continue? (y/N)
  869.  
  870.        Default action is 'No' for pressing the 'Enter' key.  Press 'y'
  871.        then 'Enter' to start diskette image extraction.
  872.  
  873.  
  874.        9.6. Example 6
  875.  
  876.        To test the integrity of the diskette image without writing out
  877.        to the diskette, simply type:
  878.  
  879.            test15 /t
  880.  
  881.        And you'll see:
  882.  
  883.           ┌────── Diskette Image Description ──────┐
  884.            Joe,
  885.            This is the latest beta release of Space
  886.            Commander.  Try it out without a joy
  887.            stick and let me know how it goes.
  888.              Regards, John
  889.           └────────────────────────────────────────┘
  890.           360K diskette image stored in file.
  891.  
  892.           100% Read
  893.  
  894.             32-bit CRC stored: DB49A615
  895.           32-bit CRC computed: DB49A615
  896.  
  897.        Note: /t overrides drive letter specified on the command line.
  898.  
  899.  
  900.                                                                       16
  901.  
  902.  
  903.  
  904.        9.7. Example 7
  905.  
  906.        Now that Joe got the diskette image.  He doesn't have a 360K or
  907.        1.2M drive (5.25" drive).  All he has is a 1.44M 3.5" drive.  He
  908.        also happens to have a spare 720K (low-density) diskette he can
  909.        use.  What can he do?  He can use the /c switch in the extract
  910.        mode of Disk eXPress or Xtract.  The /c switch can be used to
  911.        convert the diskette image from 360K to 720K, and all the data
  912.        will still be intact, and usable.  The diskette used for
  913.        conversion must be pre-formatted.  So, Joe went ahead and
  914.        formatted the diskette as a 720K diskette, and he types:
  915.  
  916.            dxp test15.exe a: /c
  917.  
  918.        And receives the following screen (answer y at the prompt):
  919.  
  920.         Checking Disk eXPress for modifications ... OK.
  921.         Checking test15.EXE for modifications ... OK.
  922.  
  923.           360K diskette image (Disk eXPress type 2)
  924.  
  925.         Diskette in drive A: is about to be overwritten
  926.         with new information.  Do you wish to continue? (y/N) y
  927.  
  928.           720K diskette found in drive A:
  929.         Converting 360K image onto 720K diskette ...
  930.  
  931.                               3%      25%       50%       75%      100%
  932.             Action Track Head ├────────┼─────────┼─────────┼─────────┤
  933.         DECOMPRESS   20    0  █████████▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  934.  
  935.        etc.
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.                                                                       17
  960.  
  961.  
  962.  
  963.        10.0. ERROR MESSAGES
  964.        _________________________________________________________________
  965.  
  966.        Disk eXPress incorporates 32-bit CRC checking for itself and the
  967.        image it produces.  In the event of a virus infection or other
  968.        means of modifications (such as errors in electronic
  969.        transmissions), the program will abort, and the following message
  970.        is displayed:
  971.  
  972.        *** File has been modified or not a valid image file.
  973.  
  974.        Here is a run down of major error messages produced by Disk
  975.        eXPress, Xtract and self-extract images: (a beep followed by one
  976.        of the following messages)
  977.  
  978.        - For bad or not properly formatted diskette during read, write,
  979.          format or verify:
  980.  
  981.          *** Read Error: Abort, Retry? (a/R):
  982.  
  983.          *** Write Error: Abort, Retry? (a/R):
  984.  
  985.          *** Format Error: Abort, Retry? (a/R):
  986.  
  987.          *** Verify Error: Abort, Retry? (a/R):
  988.  
  989.          *** Bad CRC.
  990.  
  991.          *** Sector not found.
  992.  
  993.          *** General failure reading drive X:
  994.  
  995.          *** Unknown media/inconsistent boot record.
  996.  
  997.        - When disk is full during image creation (output will be
  998.          deleted):
  999.  
  1000.          *** Error writing disk or disk full.
  1001.  
  1002.        - With a write protected diskette during diskette write:
  1003.  
  1004.          *** Diskette is write protected.
  1005.  
  1006.        - When replacing self-extract code in images with a lower
  1007.          revision level of Disk eXPress:
  1008.  
  1009.          *** Image was created by Disk eXPress x.xx
  1010.          which is of higher revision level.
  1011.  
  1012.        - When diskette drive is not ready:
  1013.  
  1014.          *** Drive X: not ready.
  1015.  
  1016.  
  1017.  
  1018.                                                                       18
  1019.  
  1020.  
  1021.  
  1022.        - When drive specified is not available or not a diskette drive:
  1023.  
  1024.          *** Invalid drive/path specified.
  1025.  
  1026.          *** Drive X: is not a floppy drive.
  1027.  
  1028.        - When attempting to replace a version 1 self-extract header with
  1029.          version 2 by the /r switch:
  1030.  
  1031.          *** filename is not a type 2 image.
  1032.  
  1033.        - When Disk eXPress or Xtract is asked to extract an unrecognized
  1034.          image file:
  1035.  
  1036.          *** Diskette image header corrupted!
  1037.  
  1038.        - When Disk eXPress or Xtract is asked to convert a diskette
  1039.          image to the same form factor diskette:
  1040.  
  1041.          *** Conversion not supported on target diskette.
  1042.  
  1043.        - Some error messages returned by Disk eXPress are displayed as:
  1044.  
  1045.          *** Error n, Drive X:
  1046.  
  1047.        In such event, please document the procedure on how to get to the
  1048.        above error, and contact me as soon as possible.
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.                                                                       19
  1078.  
  1079.  
  1080.  
  1081.        11.0. LIMITATIONS
  1082.        _________________________________________________________________
  1083.  
  1084.        When Disk eXPress is used to produce a self-extract diskette
  1085.        image, the extract code is bundled as an overhead for each image
  1086.        produced.  The overhead is currently at 25K.  This is acceptable,
  1087.        considering the size of any non-trivial diskette image is usually
  1088.        quite large (in the order of several hundred kilo bytes or even
  1089.        mega bytes).  25K should require no more than two minutes for a
  1090.        2400 baud modem to transfer, and with a 14.4K V.32bis modem, the
  1091.        overhead is less than 16 seconds.
  1092.  
  1093.        Other limitations include the inability to read a diskette drive
  1094.        over the LAN (limitation of the network driver), and Disk eXPress
  1095.        over any copy protected programs.  Another limitation is its
  1096.        inability to read over physically bad sectors.
  1097.  
  1098.        Any suggestions and comments are welcome.  Suggestions for new
  1099.        features may eventually be incorporated into a future release.
  1100.        Currently on the drawing board includes a 32-bit version for OS/2
  1101.        2.0, and the possibility of making it into a multi-threaded PM
  1102.        application with the use of System Object Model (SOM).
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.                                                                       20
  1137.